home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / rndfile210.lha / rndfile.readme < prev    next >
Encoding:
Text File  |  1994-05-04  |  3.8 KB  |  96 lines
  1. rndfile.readme
  2. $VER: rndfile.readme 1.31 (4.5.94)
  3.  
  4. By Bill Bereza  bereza@beech.csis.gvsu.edu  ac368@leo.nmc.edu
  5.  
  6.     no longer contains any code from RXBlank by Brian C. Berg,
  7.     but thanks for the idea!
  8.  
  9.  
  10. Installation:
  11.         You'll need rexxarplib.library in libs: (It's available in many places)
  12.         Then copy libs/RexxDosSupport.library to libs:
  13.             (I included this because it isn't available everywhere)
  14.  
  15.         Then copy rndfile where ever you put you ARexx scripts.
  16.  
  17. Usage: rndfile Paths/M,Pattern/K,Command/K,CmdOptions/K,ALL/S,DIRS/S,FILES/S
  18.  
  19.        You do *not* need to put a '/' at the end of the Path.
  20.  
  21.     Paths/M     :   Specify any number of paths for rndfile to search through.
  22.                     e.g. Work:Docs/
  23.                     Default is the current directory.
  24.  
  25.     Pattern/K   :   An Arp pattern for rndfile to apply to the
  26.                     list of files/dirs.
  27.                     e.g. s#?.txt
  28.                     Default is '~(#?.info)' No info files.
  29.  
  30.     Command/K   :   A program that rndfile will run on the chose file.
  31.                     e.g. PPShow
  32.                     Default is the enviroment variable DefRndCmd or 'c:list'
  33.                     You can set your own default command with:
  34.                         setenv DefRndCmd <command>
  35.  
  36.     CmdOptions/K:   Options to pass to the Command program.
  37.                     e.g. SCREEN
  38.                     Defaults to null string. (Nothing)
  39.  
  40.     ALL/S       :   Allow directories OR files to be chosen.
  41.                     This is the default option.
  42.  
  43.     DIRS/S      :   Allow only directories to be chosen.
  44.  
  45.     FILES/S     :   Allow only files to be chosen.
  46.  
  47. Examples:
  48.     RX rndfile
  49.         uses default command 'c:list' on a file in the current directory
  50.  
  51.     RX rndfile Sounds:Samples/ Pictures:Things Command=delete All
  52.         uses delete command on a random File OR Directory in those dir
  53.  
  54.     RX rndfile Sounds:Samples/ Command=Multiview CmdOptions="SCREEN BACKDROP"
  55.         uses Multiview program with SCREEN and BACKDROP options
  56.         in Sound:Samples/
  57.  
  58. Disclaimer: Don't blame me if you randomly screw something up.
  59.             By executing this script you take your life and your
  60.             files into your own hands.
  61.  
  62. ObLegal:    This script is freeware. Do what you like with it.
  63.             If you use part of this, at least give me some
  64.             credit|blame.
  65.  
  66. History:    2.10    Just a few small additions.
  67.                 +   You can now have multiple paths. (See Examples)
  68.                 +   Now will read the default command from the env-variable
  69.                     DefRndCmd.
  70.             2.00    Hooboy! Completely re-wrote the program. It's like a
  71.                     completely new program.
  72.                 +   Replaced ugly argument parsing structure with
  73.                     ReadArgs() from RexxDosSupport.library.
  74.                 +   Now I use a real template.
  75.                 +   Replaced '.info' removing routines with FileList()
  76.                     from rexxarplib.library.
  77.                 -   Now also checks for ':' instead of just '/'
  78.                     No more 'Can't find Path SYS:/'
  79.  
  80.             1.10    Fixed instructions/comments
  81.  
  82.             1.00    I wrote this for the Amiga users on alt.tv.animaniacs
  83.                     so they could play a collection of 'Wheel of Morality'
  84.                     samples. Unfortunately, I wrote this before looking at
  85.                     the sample collection. This program is useless for that.
  86.                     But it did make a useful utility.
  87.  
  88. ToDo:       Some optimization should be done in the big 'do' loop.
  89.             What more do you want? :) Send e-mail if you have a
  90.             suggestion.
  91.  
  92.             Maybe get an ARexx compiler and compile it?
  93.  
  94.             I would like to use a better implementation of ReadArgs().
  95.             I have one, but it would require a few changes.
  96.